home *** CD-ROM | disk | FTP | other *** search
/ Dr. Windows 3 / dr win3.zip / dr win3 / NEW_TECH / RCSDOC.ZIP / CO.TXT < prev    next >
Text File  |  1993-08-09  |  20KB  |  391 lines
  1.  
  2.  
  3. CO(1)                      Unix Programmer's Manual                      CO(1)
  4.  
  5.  
  6. NNNAAAMMMEEE
  7.      co - check out RCS revisions
  8.  
  9. SSSYYYNNNOOOPPPSSSIIISSS
  10.      cccooo [_o_p_t_i_o_n_s] _f_i_l_e ...
  11.  
  12. DDDEEESSSCCCRRRIIIPPPTTTIIIOOONNN
  13.      cccooo retrieves a revision from  each  RCS  file  and  stores  it  into  the
  14.      corresponding  working  file.  Each file name ending in ,,,vvv is taken to be
  15.      an RCS file; all other files are assumed to be working files.  If only  a
  16.      working file is given, cccooo tries to find the corresponding RCS file in the
  17.      directory ...///RRRCCCSSS and then in the current directory.  For more details, see
  18.      FILE NAMING below.
  19.  
  20.      Revisions of an RCS file may be checked out locked or unlocked.   Locking
  21.      a  revision  prevents  overlapping  updates.   A revision checked out for
  22.      reading or processing (e.g., compiling) need not be locked.   A  revision
  23.      checked  out  for  editing  and  later  checkin  must normally be locked.
  24.      Checkout with locking  fails  if  the  revision  to  be  checked  out  is
  25.      currently  locked  by another user.  (A lock may be broken with rrrcccsss(1).)\
  26.      Checkout with locking also requires the caller to be on the  access  list
  27.      of  the RCS file, unless he is the owner of the file or the superuser, or
  28.      the access list is empty.  Checkout without locking  is  not  subject  to
  29.      accesslist restrictions, and is not affected by the presence of locks.
  30.  
  31.      A revision is selected by options for revision or branch number,  checkin
  32.      date/time,  author,  or state.  When the selection options are applied in
  33.      combination, cccooo retrieves the latest revision that satisfies all of them.
  34.      If  none  of  the selection options is specified, cccooo retrieves the latest
  35.      revision on the default branch (normally the trunk, see the ---bbb option  of
  36.      rrrcccsss(1)).   A  revision  or  branch  number  may be attached to any of the
  37.      options ---fff, ---III, ---lll, ---ppp, ---qqq,  ---rrr,  or  ---uuu.   The  options  ---ddd  (date),  ---sss
  38.      (state),  and  ---www  (author)  retrieve  from a single branch, the _s_e_l_e_c_t_e_d
  39.      branch, which is either specified by one of ---fff,,, ..., ---uuu, or  the  default
  40.      branch.
  41.  
  42.      A cccooo command applied to an RCS file with no  revisions  creates  a  zero-
  43.      length  working  file.   cccooo  always  performs  keyword  substitution (see
  44.      below).
  45.  
  46. OOOPPPTTTIIIOOONNNSSS
  47.  
  48.      ---rrr[rev]]]
  49.           retrieves the latest revision whose number is less than or equal  to
  50.           _r_e_v.  If  _r_e_v  indicates a branch rather than a revision, the latest
  51.           revision on that branch is retrieved.  If _r_e_v is omitted, the latest
  52.           revision  on  the  default  branch  (see the ---bbb option of rrrcccsss(1)) is
  53.           retrieved.  A revision  is  composed  of  one  or  more  numeric  or
  54.           symbolic  fields  separated by periods.  The numeric equivalent of a
  55.           symbolic field is specified with the ---nnn option of the commands ccciii(1)
  56.           and rrrcccsss(1).
  57.  
  58.      ---lll[rev]]]
  59.           same as ---rrr, except that it also locks the retrieved revision for the
  60.           caller.
  61.  
  62.  
  63.  
  64.                                     \*(Dt                                    1
  65.  
  66.  
  67.  
  68. CO(1)                      Unix Programmer's Manual                      CO(1)
  69.  
  70.  
  71.      ---uuu[rev]]]
  72.           same as ---rrr, except that it unlocks the retrieved revision if it  was
  73.           locked  by  the  caller.  If _r_e_v is omitted, ---uuu retrieves the latest
  74.           revision locked by the caller; if no such lock exists, it  retrieves
  75.           the latest revision on the default branch.
  76.  
  77.      ---fff[rev]]]
  78.           forces the overwriting of the working  file;  useful  in  connection
  79.           with ---qqq.  See also FILE MODES below.
  80.  
  81.      ---kkkkkkvvv Generate keyword strings using the default form, e.g. $$$RRReeevvviiisssiiiooonnn::: 555...444
  82.           $$$  for  the  RRReeevvviiisssiiiooonnn  keyword.   A locker's name is inserted in the
  83.           value of the HHHeeeaaadddeeerrr, IIIddd, and LLLoooccckkkeeerrr keyword strings only as  a  file
  84.           is being locked, i.e. by ccciii\\\ ---lll and cccooo\\\ ---lll.  This is the default.
  85.  
  86.      ---kkkkkkvvvlll
  87.           Like ---kkkkkkvvv, except that a locker's name is  always  inserted  if  the
  88.           given revision is currently locked.
  89.  
  90.      ---kkkkkk  Generate only keyword names in keyword strings; omit  their  values.
  91.           See  KEYWORD  SUBSTITUTION  below.   For  example,  for the RRReeevvviiisssiiiooonnn
  92.           keyword, generate the string $$$RRReeevvviiisssiiiooonnn$$$ instead of $$$RRReeevvviiisssiiiooonnn::: 555...444 $$$.
  93.           This   option  is  useful  to  ignore  differences  due  to  keyword
  94.           substitution when comparing different revisions of a file.
  95.  
  96.      ---kkkooo  Generate the old keyword string, present in the  working  file  just
  97.           before  it  was  checked in.  For example, for the RRReeevvviiisssiiiooonnn keyword,
  98.           generate the string $$$RRReeevvviiisssiiiooonnn::: 111...111 $$$ instead of $$$RRReeevvviiisssiiiooonnn::: 555...444 $$$  if
  99.           that  is how the string appeared when the file was checked in.  This
  100.           can be useful for binary  file  formats  that  cannot  tolerate  any
  101.           changes  to  substrings  that  happen  to  take  the form of keyword
  102.           strings.
  103.  
  104.      ---kkkvvv  Generate only keyword values for keyword strings.  For example,  for
  105.           the  RRReeevvviiisssiiiooonnn keyword, generate the string 555...444 instead of $$$RRReeevvviiisssiiiooonnn:::
  106.           555...444 $$$.  This can help generate files in programming languages  where
  107.           it  is  hard  to  strip keyword delimiters like $$$RRReeevvviiisssiiiooonnn:::\\\ $$$ from a
  108.           string.  However, further keyword substitution cannot  be  performed
  109.           once  the  keyword  names are removed, so this option should be used
  110.           with care.  Because of this danger of losing keywords,  this  option
  111.           cannot  be  combined  with ---lll, and the owner write permission of the
  112.           working file is turned off; to edit the file  later,  check  it  out
  113.           again without ---kkkvvv.
  114.  
  115.      ---ppp[rev]]]
  116.           prints the retrieved revision on the  standard  output  rather  than
  117.           storing  it  in  the working file.  This option is useful when cccooo is
  118.           part of a pipe.
  119.  
  120.      ---qqq[rev]]]
  121.           quiet mode; diagnostics are not printed.
  122.  
  123.      ---III[rev]]]
  124.           interactive mode; the user is prompted and questioned  even  if  the
  125.           standard input is not a terminal.
  126.  
  127.  
  128.  
  129.                                     \*(Dt                                    2
  130.  
  131.  
  132.  
  133. CO(1)                      Unix Programmer's Manual                      CO(1)
  134.  
  135.  
  136.      ---ddd_d_a_t_e
  137.           retrieves the latest revision on the selected branch  whose  checkin
  138.           date/time  is  less  than or equal to _d_a_t_e. The date and time may be
  139.           given in free format.  The time zone LLLTTT stands for local time; other
  140.           common  time  zone names are understood.  For example, the following
  141.           _d_a_t_es are equivalent if local time is January 11, 1990, 8pm  Pacific
  142.           Standard Time (eight hours west of GMT):
  143.  
  144.           8:00 pm lt
  145.           4: